home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 002a / moria48.zip / CONFIG.DOC next >
Text File  |  1988-11-01  |  11KB  |  355 lines
  1.  
  2.                   The Dungeons of MORIA version 4.872
  3.                    COPYRIGHT (c) Robert Alan Koeneke
  4.  
  5.                       MSDOS port by D. G. Kneller
  6.                              Nov 1, 1988 
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13. Table of contents
  14. 1. USAGE ............................................................. 1
  15. 2. REQUIREMENTS ...................................................... 1
  16. 3. INSTALLATION ...................................................... 1
  17. 3.1. Hard drive systems .............................................. 1
  18. 3.2. High-density floppy systems ..................................... 2
  19. 3.3. 2 - 360K floppy systems ......................................... 2
  20. 4. OPTIONS ........................................................... 2
  21. 4.1. SAVE ............................................................ 2
  22. 4.2. SCORE ........................................................... 3
  23. 4.3. KEYBOARD ........................................................ 3
  24. 4.4. GRAPHICS ........................................................ 3
  25. 4.5. RAWIO ........................................................... 3
  26. 4.6. IBMBIOS ......................................................... 3
  27. 4.7. ANSI ............................................................ 4
  28. 5. ENVIRONMENT VARIABLES ............................................. 5
  29. 6. BUGS .............................................................. 5
  30. 7. AUTHOR'S ADDRESS .................................................. 5
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                  - i -                                     
  59.  
  60.  
  61.  
  62.  
  63. INTRODUCTION
  64.  
  65. This README file describes the requirements and setup necessary to get
  66. MORIA running on your MSDOS computer.  The actual game documentation is
  67. in MORIA.DOC.  Some of the game documentation will be wrong if you
  68. choose the Rogue-like command set.
  69.  
  70.  
  71. 1. USAGE
  72.  
  73.      Usage:  moria [ -nors ] [ savefile ]
  74.  
  75.      Where:  -n starts a new game, ignoring any existing save files.
  76.              -o selects the original (VMS) command set.
  77.              -r selects the Rogue-like command set.
  78.              -s prints the score file and exits.
  79.  
  80. 2. REQUIREMENTS
  81.  
  82.      640K ram (really!)
  83.      DOS 2.x or higher
  84.      2 - 360K floppy disk drives or 1 high density drive or 1 hard drive
  85.      A 24 (or 25) line by 80 column monitor.  MORIA uses either BIOS calls
  86.      or ANSI for video output so should work properly on most monitors. 
  87.      It must use ANSI to work on DEC Rainbows.  It won't work in 43-line mode
  88.      of an EGA.
  89.  
  90.  
  91. 3. INSTALLATION
  92.  
  93. MORIA is very easy to configure.  The biggest problem is that there is
  94. not enough room on a single 360K floppy disk to hold the DOS system
  95. files, MORIA.EXE (about 340K) and a MORIA save file (about 80K or so).
  96. To install MORIA, some files must be copied and 2 options in MORIA.CNF
  97. must be set.  Options and the MORIA.CNF are described more fully in the
  98. section entitled OPTIONS.  Here are a few methods of configuration.
  99. These methods are also described in the MORIA.CNF file.
  100.  
  101.  
  102. 3.1. Hard drive systems
  103.  
  104. Create a c:\games subdirectory on your hard disk and put c:\games on
  105. your PATH (see the DOS manual if you need help with PATH). Copy
  106. MORIA.EXE and MORIA.CNF to c:\games.  Edit MORIA.CNF and put in the
  107. options:
  108.  
  109.      SAVE c:\games\moria.sav;n
  110.      SCORE c:\games\moria.scr
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                                  - 1 -                                     
  118.  
  119. 3.2. High-density floppy systems
  120.  
  121. This is about as easy as for a hard disk.  Format a diskette and put the
  122. DOS system files on it (use FORMAT A:/S).  Copy MORIA.EXE and MORIA.CNF
  123. to that diskette.  Edit MORIA.CNF and put in the options:
  124.  
  125.      SAVE a:\moria.sav
  126.      SCORE a:\moria.scr
  127.  
  128.  
  129.  
  130. 3.3. 2 - 360K floppy systems
  131.  
  132. You will need to use 2 floppy diskettes.  Format a diskette and put the
  133. DOS system files on it (use FORMAT A:/S).  Copy MORIA.CNF to this
  134. diskette. This diskette will go in drive A when you want to play MORIA.
  135. Format a second diskette (no /S) and copy MORIA.EXE to it.  This
  136. diskette will go in drive B.  Edit MORIA.CNF and put in the options:
  137.  
  138.      SAVE a:moria.sav
  139.      SCORE a:moria.scr
  140.  
  141.  
  142. When you want to play MORIA, put both diskettes in and type "B:MORIA"
  143.  
  144.  
  145.  
  146. 4. OPTIONS
  147.  
  148. When MORIA starts up it looks along your PATH for the file "MORIA.CNF".
  149. MORIA.CNF contains configuration information for MORIA in the form of
  150. options.  Options have a name and perhaps a value.  If the option
  151. doesn't have a value, simply mentioning its name selects that option.
  152. Here are the options.
  153.  
  154. 4.1. SAVE
  155.  
  156. The SAVE option has 1 argument, the name of a file where saved games
  157. will be stored.  Normally, when you start MORIA by typing "MORIA file",
  158. MORIA will try to use "file" as the name of a saved game.  The SAVE
  159. option allows you to give the name of the save file so you don't have to
  160. type it in each time you save or restore a game.  A sample SAVE option
  161. is:
  162.  
  163.      SAVE c:\games\moria.sav;n
  164.  
  165.  
  166. The ";n" is optional.  If given it means that MORIA should never prompt
  167. you for the name of the save file.  If the SAVE option isn't given,
  168. MORIA defaults to the file MORIA.SAV in the same directory as MORIA.CNF.
  169. Also, the SAVE option can be just ";n", which means use the default name
  170. without prompting.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.                                  - 2 -                                     
  177.  
  178. 4.2. SCORE
  179.  
  180. The SCORE option has 1 argument, the name of the file where the top
  181. scores are kept.  A sample SCORE option is:
  182.  
  183.      SCORE c:\games\moria.scr
  184.  
  185.  
  186. If the SCORE option isn't given, MORIA defaults to the file MORIA.SCR in
  187. the same directory as MORIA.CNF.
  188.  
  189.  
  190. 4.3. KEYBOARD
  191.  
  192. MORIA can be played with either of 2 styles of commands.  There is the
  193. original VMS-style commands and a Rogue-style set of commands. The
  194. choice of command set affects the keyboard letters used for doing the
  195. various game commands.  The KEYBOARD value can be either "ROGUE" or
  196. "VMS".  The default is to use the original VMS-style commands.
  197.  
  198.  
  199. 4.4. GRAPHICS
  200.  
  201. The GRAPHICS option takes 2 arguments, the ASCII number for the
  202. character to be used for displaying the walls and floors.  For example,
  203. to use '#' for the walls and '.' for the floors, the GRAPHICS option
  204. would be:
  205.  
  206.      GRAPHICS 35 46
  207.  
  208.  
  209. Incidentally, these also are the default characters that are used if the
  210. GRAPHICS option is not specified.
  211.  
  212.  
  213. 4.5. RAWIO
  214.  
  215. Normally DOS does some extra work whenever a character is input from the
  216. keyboard.  One of the tasks is to interpret the special characters ^S
  217. (control-S, which does a scroll lock) ^C (control-C, which acts like
  218. control-Break) and ^P (control-P, which acts like control-PrtSc,
  219. toggling output to your printer or giving an error message if you don't
  220. have one). The RAWIO option will be used to tell DOS to not do this
  221. extra work by making the input (and output) operate in "raw" mode. This
  222. is good because ^P (a MORIA command) will now work. As well, screen
  223. output will be somewhat faster.
  224.  
  225. URGENT!  RAWIO will not work on Dec Rainbows and will probably lock up
  226. the computer.
  227.  
  228.  
  229. 4.6. IBMBIOS
  230.  
  231. IBMBIOS enables the use of a BIOS call to read input from the keyboard.
  232.  
  233.  
  234.  
  235.                                  - 3 -                                     
  236.  
  237. The advantage of this is that the numeric keypad will then be useable as
  238. direction keys for moving around.  With this option the keypad keys map
  239. to the directions:
  240.  
  241.              7 up & left      8 up        9 up & right
  242.              4 left           5 nothing   6 right
  243.              1 down & left    2 down      3 down & right
  244.  
  245.      And other keypad keys map to:
  246.  
  247.                                           -   rest
  248.                                           +   previous message
  249.              Ins inventory        Del rest
  250.  
  251.  
  252. If you are using the Rogue-style command set, the shift key and NumLock
  253. key modify these commands. With the shift key down, 7 will be "run up
  254. and left", 8 will be "run up", etc.  The NumLock key is used as a toggle
  255. between moving and tunneling. With NumLock enabled, 7 will be "tunnel up
  256. and left", etc.
  257.  
  258.  
  259. 4.7. ANSI
  260.  
  261. The ANSI option tells MORIA to use ANSI sequences rather than using BIOS
  262. calls for doing output.  You must use the ANSI option if you are playing
  263. MORIA on a DEC Rainbow.  On IBM PCs, ATs and clones there should be no
  264. need to use this option and you can safely ignore the rest of this
  265. section.
  266.  
  267. The ANSI option takes three optional arguments:  check_ansi, move_opt and
  268. use_tgoto.  If no arguments aren't given, they are assumed to be Y (yes),
  269. Y and N (no), respectively.  The usage is
  270.  
  271.      ANSI [ check_ansi [ move_opt [ use_tgoto ] ] ]
  272.  
  273. An example is:
  274.  
  275.      ANSI Y N
  276.  
  277. check_ansi tells MORIA to check for ANSI.SYS when starting up.  You may have
  278. to disable this check if MORIA insists you don't have ANSI installed, but you
  279. know you do.  move_opt tries to reduce the amount of output being sent to the
  280. screen.  use_tgoto tells MORIA to use the actual TERMCAP tgoto() routine.  The
  281. default is to use a faster routine which only works for ANSI-like terminals.
  282.  
  283. When the ANSI option is chosen, MORIA looks for ANSI control strings in
  284. a file called TERMCAP, first in the current directory, then in directory
  285. ETC.  A sample TERMCAP file is supplied.  Basically, this file maps
  286. between logical cursor operations (eg. "cursor up") to ANSI sequences
  287. (eg ESC [ A).  In the file, ESC (escape) is represented as \E.  MORIA
  288. uses the following logical operations:
  289.  
  290.  
  291.  
  292.  
  293.  
  294.                                  - 4 -                                     
  295.  
  296.      ce      clear to end of line
  297.      cl      clear screen
  298.      cm      cursor motion (only if use_tgoto is chosen)
  299.      nd      cursor forward (non-destructive space)
  300.      bc      cursor back
  301.      up      cursor up
  302.      xd      cursor down
  303.      li      number of lines on the screen
  304.  
  305. MORIA can also use:
  306.  
  307.      ti      terminal initialization string
  308.      te      terminal end string
  309.  
  310.  
  311. 5. ENVIRONMENT VARIABLES
  312.  
  313. MORIA uses the environment variable USER to determine your real name (as
  314. opposed to your role playing name in the game).  The USER environment
  315. variable can be set from DOS with:
  316.  
  317.      set USER = kneller
  318.  
  319. If the USER variable isn't set, MORIA just uses the name "player".
  320.  
  321. If the ANSI option is chosen, MORIA uses the variable TERM to determine
  322. the terminal information to extract from the TERMCAP file.  If the TERM
  323. variable isn't set, MORIA assumes the value "ibmpc-mono".
  324.  
  325.  
  326.  
  327. 6. BUGS
  328.  
  329. I have not played this game much so there may be bugs which I have not
  330. seen yet.  Please report them to me so I can fix them.
  331.  
  332.  
  333. 7. AUTHOR'S ADDRESS
  334.  
  335. If you have any questions or bug reports please contact me at:
  336.  
  337.      D. G. Kneller
  338.      1349  10th avenue
  339.      San Francisco, CA 94122
  340.      USA
  341.  
  342.      or by electronic mail at:
  343.  
  344.      ARPA:   kneller@cgl.ucsf.edu
  345.      BITNET: kneller@ucsfcgl.bitnet
  346.      UUCP:   ...ucbvax!ucsfcgl!kneller
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.                                  - 5 -                                     
  354.  
  355.